home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / eemgr10.zip / EEMGR.DOC < prev    next >
Text File  |  1991-10-18  |  12KB  |  262 lines
  1.  
  2.  
  3.  
  4.                    EPIC Event Manager (EEMGR) - version 1.00
  5.  
  6.                        (c) Copyright 1991, Ernie Johnson
  7.                               All Rights Reserved
  8.  
  9.  
  10.  
  11.  
  12.     What the EPIC Event Manager Does
  13.     ----------------------------------------------------------------------
  14.     It provides a simple, easy to use method for running BBS events on
  15.     certain days, or on a daily level.
  16.  
  17.     It was designed to work with PCBoard, but I'm sure will work in
  18.     conjunction with almost every other BBS type on the market that
  19.     makes use of batch files for running the nightly events.
  20.  
  21.     EEMGR can also be used on computer systems without a BBS - the best
  22.     place to use EEMGR is in your AUTOEXEC.BAT file - of course, EEMGR
  23.     will work better if you turn your computer on once per day, and shut
  24.     it off in the evening.
  25.  
  26.  
  27.     About "EEMGR":
  28.     ----------------------------------------------------------------------
  29.     Quite simply, I was getting tired of having my BBS run events every
  30.     day for 30 minutes or longer.  I have my system pack the message
  31.     bases, update file and conference lists, run door maintenance
  32.     programs, etc.
  33.  
  34.     I figured that if I was able to run my message base packing programs
  35.     once a week the BBS would remain online a bit longer in case someone
  36.     wants to get on at 6am (when I run my events).
  37.  
  38.     This way, the message bases get packed once per week instead of
  39.     everyday, saving me about 20 minutes in my daily event.  Other uses
  40.     could be about anything - perhaps you are on a slow echo mail system
  41.     and you only need to get mail once a week - just set up the proper
  42.     event in EEMGR and you're all set - no more getting up at 6 am just
  43.     to do a once a week mail run.  Perhaps you have programs to scan
  44.     your drives and delete old and outdated programs, this will be great
  45.     for doing that once a week (or more often if you prefer), EEMGR is
  46.     also not limited to working with a BBS - why not set it up to do a
  47.     weekly full backup of your system and daily incremental backups?
  48.     Or perhaps virus scans?  EEMGR uses easy to follow batch files along
  49.     with the EEMGR EXEcuatble program so setting up can be as simple or
  50.     as complex as you want!
  51.  
  52.  
  53.     Setting up EEMGR
  54.     ----------------------------------------------------------------------
  55.     Simply copy the EEMGR.EXE file to a directory that is handy for it.
  56.     Thats all you need to get started, all the other files are simply
  57.     samples to show what EEMGR does.
  58.  
  59.     You will need to configure the EEMGR.CFG file to suit your needs
  60.     when/if you decide to use EEMGR.
  61.  
  62.     If you wish to see what EEMGR is all about, after unarchiving the
  63.     program, run the TEST.BAT file (type TEST and press ENTER).  It will
  64.     run the appropriate batch files as listed in the EEMGR.CFG file so
  65.     you can see what EEMGR will do for you.
  66.  
  67.  
  68.     EEMGR Configuration file
  69.     ----------------------------------------------------------------------
  70.     line 1:  batch file drive, path & name for DAILY  event
  71.     line 2:                                    SUNDAY
  72.     line 3:                                    MONDAY
  73.     line 4:                                    TUESDAY
  74.     line 5:                                    WEDNESDAY
  75.     line 6:                                    THURSDAY
  76.     line 7:                                    FRIDAY
  77.     line 8:                                    SATURDAY
  78.  
  79.     Based on the above information, if you wanted a daily event, on line
  80.     1, enter the full drive and path name of the batch file you wish to
  81.     run on a daily basis.  If you do not wish to have a daily event,
  82.     simply use the word NONE (upper or lower case).
  83.  
  84.     Lines 2 through 8 are for each day and follow the same structure as
  85.     the daily event line. Use the word NONE if you don't wish to have an
  86.     event schedule for a specific day.
  87.  
  88.     Here is an example:
  89.  
  90.                           J:\EEMGR\DAILY.BAT
  91.                           J:\EEMGR\SUNDY.BAT
  92.                           NONE
  93.                           NONE
  94.                           NONE
  95.                           NONE
  96.                           NONE
  97.                           J:\EEMGR\SATDY.BAT
  98.  
  99.     For more ideas, here's an idea of what each batch file contains:
  100.  
  101.     DAILY.BAT - (run daily) general system maintenance update
  102.     conference, directory files, etc, run door maintenance,  update user
  103.     securities (file ratios)
  104.  
  105.     SUNDY.BAT - (gets run on Sunday) in addition to DAILY.BAT, this
  106.     batch file runs the PCBPACK program to clean out old, duplicate
  107.     messages in my message conferences (220 of them).
  108.  
  109.     SATDY.BAT - (gets run on Saturday) in addition to DAILY.BAT this
  110.     batch file runs a virus scan on my entire system, if its passes
  111.     (I've never seen a virus yet) it backs up my main BBS drive.
  112.  
  113.  
  114.     EEMGR Batch Files
  115.     ----------------------------------------------------------------------
  116.     As you can see, these batch files are completely user definable.
  117.     In the batch file you can run anything you can run from any other
  118.     batch file with one exception.   You can not run TSR's from EEMGR's
  119.     batch files!  I would encourage you to try all the programs in your
  120.     regular events through EEMGR before actually putting EEMGR into use
  121.     on a BBS system - just in case!  I do run EEMGR on my system and it
  122.     does daily events and specific events Saturday and Sundays and I
  123.     haven't seen any problems (yet).
  124.  
  125.  
  126.     Running EEMGR
  127.     ----------------------------------------------------------------------
  128.     Just type EEMGR and press ENTER.  The program will give you a short
  129.     screen on how to use EEMGR.
  130.  
  131.     You do need to pass the name of the configuration file as a command
  132.     line argument to EEMGR.
  133.  
  134.     For example, if you created (or edited) the EEMGR.CFG file, you'd
  135.     need to type:
  136.  
  137.     EEMGR EEMGR.CFG and press ENTER.
  138.  
  139.     if EEMGR is in a different directory than EEMGR.EXE, pass the full
  140.     drive, path and filename to EEMGR such as:
  141.  
  142.     EEMGR J:\EEMGR\EEMGR.CFG and press ENTER.
  143.  
  144.     If you are running EEMGR as an event manager for PCBoard, you'll
  145.     want to copy your existing EVENT.SYS file into the batch file for
  146.     your daily events, and create a new EVENT.SYS with a line that runs
  147.     EEMGR (based on the previous examples).
  148.  
  149.     Lastly, if you are having problems getting EEMGR configured and
  150.     running properly, give us a call on our tech support number listed
  151.     below, or call our BBS and leave a message.
  152.  
  153.     Tech Support: (519) 357-1941 call between 6pm and 11pm EST to get
  154.     a voice answer (most of the time), or leave a message on the
  155.     answering machine and someone will get back to you.
  156.  
  157.     Our BBS is (519) 357-1943 and is on almost 24 hours a day Monday to
  158.     Friday (thanks to EEMGR) and about 23 hours a day Saturday and
  159.     Sunday.  As of the time of this writing we only have a 2400 baud
  160.     modem online, but by the time most users read this we will have a
  161.     U.S. Robotics Dual Standard.
  162.  
  163.  
  164.     Errors and "bugs":
  165.     ----------------------------------------------------------------------
  166.     Under normal circumstances, you'll never have a problem with EEMGR.
  167.     The only foreseeable problems would be simple things like "file not
  168.     found errors" from your batch files and the next would be EEMGR Swap
  169.     errors.  EEMGR swaps itself out to XMS, EMS, or disk when running a
  170.     batch file to save RAM - if a TSR gets loaded in the event, EEMGR
  171.     will not be able to reload itself.
  172.  
  173.                     DO NOT LOAD A TSR IN YOUR EVENTS!
  174.  
  175.     Other than those problems, nothing _should_ crop up and cause
  176.     problems.  EEMGR has been well tested and the worst thing that I can
  177.     make it do is the problem caused by loading a TSR.  If you get file
  178.     not found errors, be sure to run your event batch files without
  179.     using EEMGR first to test them.
  180.  
  181.  
  182.     Warranty & Guarantee's:
  183.     ----------------------------------------------------------------------
  184.     EEMGR is in no way warranted to be free of defects, bugs, etc.  It
  185.     has, however, gone through extensive testing on my BBS, and I have
  186.     not seen any adverse effects.  I am not responsible for any adverse
  187.     effects it has on your system (just in case).  You should take any
  188.     steps to avoid virus infection and scan the file for viruses before
  189.     using it on your system.
  190.  
  191.     EEMGR is copyrighted software.  Please do not make any modifications
  192.     to it!  I am letting you use this software for almost nothing, and
  193.     would expect some common courtesy in return.  If you have suggestions
  194.     for modifications/improvements, please forward them to me through
  195.     one of the methods below.
  196.  
  197.     Feel free to pass EEMGR to everyone you know, but please keep the
  198.     original archive contents and files the way they originated.  Sysops
  199.     who feel it necessary to include a BBS advertisement inside the
  200.     archive, feel free to do so, but PLEASE use the file name "BBS.AD"
  201.     so people know what to look for if they are looking for BBS
  202.     advertisements.  If you do these and a BBS.AD file already exists,
  203.     feel free to delete it and add your own in its place.
  204.  
  205.  
  206.     How to register:
  207.     ----------------------------------------------------------------------
  208.     Send your name, address, BBS name and number on a postcard, letter,
  209.     etc to:
  210.  
  211.                               Ernie Johnson
  212.                               P.O. Box 607
  213.                               Wingham, Ontario
  214.                               N0G 2W0  -  Canada
  215.  
  216.  
  217.     Call EPIC BBS at 519-357-1943.  At the time of this writing we only
  218.     support 2400 baud, but will be upgrading to a USR Dual Standard in
  219.     the near future.  To register on EPIC, simply leave a comment to the
  220.     SysOp with your name, address, BBS name and number.
  221.  
  222.     Call me voice.  My number is 519-357-1941 Eastern time.  Call
  223.     between 7pm and 11pm to get me home (most of the time), or leave a
  224.     message on the answering machine.
  225.  
  226.     Lastly, leave me a message in the ILink, RIME or City2City Shareware
  227.     echo mail conferences. I read mail in both of these conferences on a
  228.     daily basis.
  229.  
  230.     This is all you need to do to register EEMGR - put simply, all I
  231.     want to know is if people appreciate these little freebies I've been
  232.     writing, and if I should continue to spend time doing so.  If you
  233.     feel EEMGR is really great and is worth money, feel free to send
  234.     whatever you feel its worth to you.  Personally I don't feel its
  235.     worth too much as I threw the program and documentation together in
  236.     about 2 hours (the program was the easy part), and its something I
  237.     wanted for my BBS system and figured that other sysops might want to
  238.     use it as well - another one of my contributions to todays very busy
  239.     sysops!
  240.  
  241.  
  242.     Upgrades/Improvements:
  243.     ----------------------------------------------------------------------
  244.     Since I am not charging money for EEMGR, don't expect me to send
  245.     product upgrades to you.  I will leave it up to you to get upgrades
  246.     as they are released.  For the most part, EEMGR will not likely have
  247.     too many updates as it is a simple program.  Its been extensively
  248.     tested and know bugs have been noticed.
  249.  
  250.  
  251.     Lastly:
  252.     ----------------------------------------------------------------------
  253.     Please register!  Its only the cost of a postcard/stamp, or phone
  254.     call, but it would tell me if I should continue to write these
  255.     little freebie doors for fellow PCBoard SysOps and spend time writing
  256.     documentation like this.  Your registration does mean a lot ot me,
  257.     and my continuation of quality software at affordable prices!
  258.  
  259.  
  260.     EEMGR Documentation Copyright 1991 Ernie Johnson - All Rights Reserved
  261.     EEMGR Program       Copyright 1991 Ernie Johnson - All Rights Reserved
  262.